package rest;

import javax.jws.WebService;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;
import java.util.List;

@WebService
@Path("/student")
public interface StudentService {

    /**
     * 以【xml】格式发布，获得的也只有xml
     *
     * @param id 学生id
     * @return 学生信息
     */
    @GET
    @Produces(MediaType.APPLICATION_XML)
    @Path("/query/{id}")
    public Student queryStudent(@PathParam("id") long id);

    /**
     * 以json和xml两种格式发布
     *  127.0.0.1:8080/工程名/ws/rest/student/query/1  -- 默认是xml
     *  127.0.0.1:8080/工程名/ws/rest/student/querylist/1?_type=xml  --返回xml格式
     *  127.0.0.1:8080/工程名/ws/rest/student/querylist/1?_type=json  --返回json格式
     * @param name 学生姓名
     * @return 学生列表
     */
    @GET
    @Produces({"application/json;charset=utf-8", MediaType.APPLICATION_XML})
    @Path("/querylist/{name}")
    public List<Student> queryStudentList(@PathParam("name") String name);

}
